home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / spitfire / sf322.zip / SFSENDIT.ZIP / SFSENDIT.DOC < prev   
Text File  |  1992-03-20  |  8KB  |  188 lines
  1.                                  SFSENDIT
  2.                                Version 1.0
  3.                     Copyright (C) by Mike Woltz, 1992
  4.                           Buffalo Creek Software
  5.                                A Member Of 
  6.                  The Association Of Shareware Professionals
  7.     
  8.  
  9.     INTRODUCTION
  10.     ------------
  11.     
  12.         SFSENDIT is a utility written by Mike Woltz, author of SPITFIRE
  13.     Bulletin Board System.  SFSENDIT is designed to be used with SPITFIRE
  14.     and is used to flag files for sending to a specific caller or group
  15.     of callers with a common security level.  When a file is flagged for
  16.     sending, the file name and file area is stored in the SFUSERS.DAT
  17.     file.  SFSENDIT is written in assembler language which contributes to
  18.     its quick execution and small file size.
  19.  
  20.        
  21.     USAGE
  22.     -----
  23.  
  24.         SFSENDIT should be placed in and executed from the SPITFIRE
  25.     home directory.  If you attempt to execute SFSENDIT from a directory
  26.     other than the SPITFIRE home directory, a message will display
  27.     that SFNODE.DAT has not been found and operation is halted.  When
  28.     executing SFSENDIT the following menu will be displayed on the screen:
  29.     
  30.         
  31.     <A>......Add Caller File Flag       <C>....Clear Caller File Flag
  32.     <D>..Delete By Security Level       <S>..Security Level File Flag
  33.     <R>...Review Caller File Flag       <P>......Purge All File Flags
  34.     <V>.......View All File Flags       <Q>......................Quit
  35.     
  36.     SFSENDIT MENU - [A C D S R P V Q]?
  37.  
  38.     Each of the menu options are explained below.
  39.  
  40.     <A>.....Add Caller File Flag
  41.     
  42.        This option allows you to flag a file for a specific caller.  After
  43.     this option is selected, SFSENDIT will prompt you to enter the complete
  44.     or partial name of the caller to whom the file will be flagged for 
  45.     sending.  SFSENDIT will display the names of any callers to the BBS
  46.     whose name corresponds to the information inputted and ask whether
  47.     that particular caller is one you are searching for.  SFSENDIT will
  48.     will also notify you if no match is found.
  49.     
  50.        Once establishing the caller to whom the file is flagged for
  51.     sending, SFSENDIT will request the name of the file to be sent.
  52.     Enter the file name and extension of the file you wish to be
  53.     sent to the caller.  Next, you will be asked to input the the
  54.     number of the SPITFIRE file area in which the file resides.  If
  55.     SFSENDIT does not find the file in this file area, it will
  56.     display the path of the SPITFIRE file area, file name, and a
  57.     message informing you the03at the file could not be found and that
  58.     SFSENDIT is halting operation.
  59.     
  60.        Finally, after the file flag has been set for the caller,
  61.     SFSENDIT will prompt you to enter whether the file should
  62.     be deleted after it is sent.
  63.  
  64.     <C>....Clear Caller File Flag
  65.  
  66.        This option allows you to clear any file flags for a specific
  67.     caller.  You will be prompted to enter the complete or partial
  68.     name of the caller whose file flag you are clearing.       
  69.  
  70.     <S>..Security Level File Flag
  71.  
  72.        This option allows you to flag a file for a specific security
  73.     level.  After this option is selected, SFSENDIT will prompt you to
  74.     enter the security level you wish to flag the file for.
  75.     
  76.        After entering the security level the file will be flagged for,
  77.     SFSENDIT will request the name of the file to be sent.
  78.     Enter the file name and extension of the file you wish to be
  79.     sent to the caller.  Next, you will be asked to input the the
  80.     number of the SPITFIRE file area in which the file resides.  If
  81.     SFSENDIT does not find the file in this file area, it will
  82.     display the path of the SPITFIRE file area, file name, and a
  83.     message informing you that the file could not be found and that
  84.     SFSENDIT is halting operation.
  85.     
  86.        Once the file flagging is completed, SFSENDIT will display a
  87.     list which tells to whom the file has been flagged to be sent.
  88.         
  89.     <D>..Delete By Security Level
  90.  
  91.        This option allows you to clear any file flags for a specific
  92.     security level.  You will be prompted to enter the security level
  93.     so that all file flagging for that particular security level will
  94.     be cleared.
  95.     
  96.     <R>...Review Caller File Flag
  97.     
  98.        This option will report the file flagged for a particular
  99.     caller.  The user is prompted to enter the complete or partial
  100.     name of the caller.  If no match is found, SFSENDIT will notify
  101.     you that a match could not be made from the information entered.
  102.     If a match is found, SFSENDIT will list the file that has been
  103.     flagged to be sent to that caller.
  104.     
  105.     <P>......Purge All File Flags
  106.  
  107.        Selecting this option, will cause all file flagging to be
  108.     removed from the SFUSERS.DAT file.
  109.     
  110.     <V>.......View All File Flags
  111.     
  112.        When this option is selected, SFSENDIT will display each file
  113.     that has been flagged and the caller to whom the file has been
  114.     flagged for.  If there have been no files flagged, SFSENDIT will
  115.     report that no files have been flagged.
  116.     
  117.     <Q>......................Quit
  118.  
  119.        This option will exit the SFSENDIT utility and return the user to 
  120.     the DOS prompt.
  121.  
  122.  
  123.     LIMITATIONS OF SFSENDIT
  124.     -----------------------
  125.     
  126.        SFSENDIT is a simple utility and designed only to send one file to
  127.     a particular caller or group of callers with a common security level. 
  128.     Other similar utilities exist that offer more complex file flagging
  129.     schemes.  If SFSENDIT does not meet your needs, you should perhaps
  130.     try some of these other utilities.  However, it should be mentioned
  131.     that it is possible to send more than one file at a time by zipping
  132.     the desired files together into one file.  
  133.     
  134.        Also, it should be noted that SFSENDIT will not work when logged 
  135.     on locally.
  136.     
  137.     
  138.     ADDITIONAL INFORMATION REGARDING SFSENDIT
  139.     -----------------------------------------
  140.     
  141.        If the file flagged and downloaded is from a free SPITFIRE
  142.     file area, the download will not be added to the caller's download
  143.     statistics.  If the file flagged and downloaded is from a 
  144.     non-free file area, the download will be added to the caller's
  145.     download statistics.
  146.  
  147.       A file flagged for downloading, must reside in a SPITFIRE file
  148.    area.  However, it is not necessary for the file to appear in
  149.    the SFFILES.BBS listing.
  150.    
  151.       It should also be noted, that SFSENDIT does no checking to
  152.    verify the caller has security required to access the file area
  153.    for which the file is to be downloaded.  Keeping this in mind,
  154.    it would be possible to set up a "dummy" file area on the SPITFIRE
  155.    BBS with an extremely high security.  This would prevent the file
  156.    area from being accessible to the callers of the BBS and could be
  157.    used for placing files to be flagged and downloaded with SFSENDIT.
  158.  
  159.  
  160.     DISTRIBUTION
  161.     ------------
  162.  
  163.        SFSENDIT is distributed under the shareware concept.  You are
  164.     free to distribute the SFSENDIT program as long as it remains
  165.     unmodified and no fee is charged.  If you continue to use this 
  166.     program after an adequate evaluation period a fee is required.
  167.     A $5.00 fee is required of register SFSENDIT.  SFSENDIT has no
  168.     registration fee for Sysops who have purchased a license to
  169.     operate SPITFIRE.
  170.  
  171.  
  172.     DISCLAIMER
  173.     ----------
  174.         
  175.        Mike Woltz and/or Buffalo Creek Software shall in no way be 
  176.     held responsible for any damage incurred while operating SFSENDIT.
  177.     All responsibility lies with the user of the software.
  178.  
  179.        The documentation for SFSENDIT is contributed by Jacque
  180.     Shipley and The Mother Board BBS.  The shareware version of
  181.     SPITFIRE and other SPITFIRE utilities are available for download
  182.     from:
  183.  
  184.          Buffalo Creek's BBS              The Mother Board BBS
  185.           Mike Woltz, Sysop               Jacque Shipley, Sysop
  186.            (515) 225-8496                    (515) 986-3464
  187.     38400/19200/9600/2400/1200 Baud      19200/9600/2400/1200 Baud
  188.